home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / conv / mcvert.lha / mcvert / mcvert.man < prev    next >
Text File  |  1994-12-17  |  10KB  |  329 lines
  1. ***nroff: unrecognized command .UC 4.2
  2.  
  3. ***nroff: unrecognized command .ie  .in +
  4.  
  5. ***nroff: unrecognized command .el .in +3
  6.  
  7. ***nroff: unrecognized command .ie  .ti -
  8.  
  9. ***nroff: unrecognized command .el .ti -3
  10.  
  11. ***nroff: unrecognized command .ie  .in +
  12.  
  13. ***nroff: unrecognized command .el .in +3
  14.  
  15. ***nroff: unrecognized command .ie  .ti -
  16.  
  17. ***nroff: unrecognized command .el .ti -3
  18.  
  19. ***nroff: unrecognized command .ie  .in +
  20.  
  21. ***nroff: unrecognized command .el .in +3
  22.  
  23. ***nroff: unrecognized command .ie  .ti -
  24.  
  25. ***nroff: unrecognized command .el .ti -3
  26.  
  27. ***nroff: unrecognized command .ie  .in +
  28.  
  29. ***nroff: unrecognized command .el .in +3
  30.  
  31. ***nroff: unrecognized command .ie  .ti -
  32.  
  33. ***nroff: unrecognized command .el .ti -3
  34.  
  35. ***nroff: unrecognized command .ie  .in +
  36.  
  37. ***nroff: unrecognized command .el .in +3
  38.  
  39. ***nroff: unrecognized command .ie  .ti -
  40.  
  41. ***nroff: unrecognized command .el .ti -3
  42.  
  43. ***nroff: unrecognized command .ie  .in +
  44.  
  45. ***nroff: unrecognized command .el .in +3
  46.  
  47. ***nroff: unrecognized command .ie  .ti -
  48.  
  49. ***nroff: unrecognized command .el .ti -3
  50.  
  51. ***nroff: unrecognized command .ie  .in +
  52.  
  53. ***nroff: unrecognized command .el .in +3
  54.  
  55. ***nroff: unrecognized command .ie  .ti -
  56.  
  57. ***nroff: unrecognized command .el .ti -3
  58.  
  59. ***nroff: unrecognized command .ie  .in +
  60.  
  61. ***nroff: unrecognized command .el .in +3
  62.  
  63. ***nroff: unrecognized command .ie  .ti -
  64.  
  65. ***nroff: unrecognized command .el .ti -3
  66.  
  67. ***nroff: unrecognized command .ie  .in +
  68.  
  69. ***nroff: unrecognized command .el .in +3
  70.  
  71. ***nroff: unrecognized command .ie  .ti -
  72.  
  73. ***nroff: unrecognized command .el .ti -3
  74.  
  75. ***nroff: unrecognized command .ie  .in +
  76.  
  77. ***nroff: unrecognized command .el .in +3
  78.  
  79. ***nroff: unrecognized command .ie  .ti -
  80.  
  81. ***nroff: unrecognized command .el .ti -3
  82.  
  83. ***nroff: unrecognized command .ie  .in +
  84.  
  85. ***nroff: unrecognized command .el .in +3
  86.  
  87. ***nroff: unrecognized command .ie  .ti -
  88.  
  89. ***nroff: unrecognized command .el .ti -3
  90.  
  91. ***nroff: unrecognized command .ie  .in +
  92.  
  93. ***nroff: unrecognized command .el .in +3
  94.  
  95. ***nroff: unrecognized command .ie  .ti -
  96.  
  97. ***nroff: unrecognized command .el .ti -3
  98.  
  99. ***nroff: unrecognized command .ie  .in +
  100.  
  101. ***nroff: unrecognized command .el .in +3
  102.  
  103. ***nroff: unrecognized command .ie  .ti -
  104.  
  105. ***nroff: unrecognized command .el .ti -3
  106.  
  107. ***nroff: unrecognized command .ie  .in +
  108.  
  109. ***nroff: unrecognized command .el .in +3
  110.  
  111. ***nroff: unrecognized command .ie  .ti -
  112.  
  113. ***nroff: unrecognized command .el .ti -3
  114.  
  115. ***nroff: unrecognized command .ie  .in +
  116.  
  117. ***nroff: unrecognized command .el .in +3
  118.  
  119. ***nroff: unrecognized command .ie  .ti -
  120.  
  121. ***nroff: unrecognized command .el .ti -3
  122.  
  123. ***nroff: unrecognized command .ie  .in +
  124.  
  125. ***nroff: unrecognized command .el .in +3
  126.  
  127. ***nroff: unrecognized command .ie  .ti -
  128.  
  129. ***nroff: unrecognized command .el .ti -3
  130.  
  131. MCVERT (LOCAL)             May 5, 1987             MCVERT (LOCAL)
  132.  
  133.  
  134.  
  135. NAME    NAME  
  136.      mcvert  -  BinHex  4.0  to  MacBinary  file  conversion
  137.      utility 
  138.  
  139. SYNOPSIS    SYNOPSIS  
  140.      pmcvert q    [-options]    name...        [[-options]
  141.      name...]...  
  142.  
  143. DESCRIPTION    DESCRIPTION  
  144.      The pmcvert q program translates MacIntosh files from 
  145.      one format  to  another.   The primary formats in which
  146.      MacIntosh files are represented on non-Macs are: 
  147.  
  148.      pMacBinary: q An eight bit wide representation of the 
  149.      data and resource forks of a Mac file and  of  relevant
  150.      Finder  information,  MacBinary files are recognized as
  151.      "special"  by  several  MacIntosh  terminal  emulators.
  152.      These  emulators,  using  Kermit or Xmodem or any other
  153.      file transfer protocol, can separate the incoming  file
  154.      into  forks  and  appropriately  modify  the Desktop to
  155.      display icons, types, creation dates, and the like.  
  156.  
  157.      pBinHex 4.0: q A seven bit wide representation  of  a
  158.      Mac  file with CRC error checking, BinHex 4.0 files are
  159.      designed for  communication  of  Mac  files  over  long
  160.      distance, possibly noisy, seven bit wide paths.  
  161.  
  162.      pPackIt:  q PackIt files are actually representations
  163.      of  collections  of   Mac   files,   possibly   Huffman
  164.      compressed.   Packing many small related files together
  165.      before a MacBinary transfer or a translation to  BinHex
  166.      4.0 is common practice.  
  167.  
  168.      pText:  q  A MacIntosh ends each line of a plain text
  169.      file with a carriage return character (^M), rather than 
  170.      the newline character (^J) that some  systems  seem  to
  171.      prefer.   Moreover,  a  MacBinary  file  has  prepended
  172.      Finder information that non-MacIntoshes don't need.  
  173.  
  174.      pData, Rsrc: q A Data or Rsrc file is the exact  copy
  175.      of the data or resource fork of a MacIntosh file.  
  176.  
  177.      It  is  the  purpose  of this program to convert to the
  178.      MacBinary format files in other of the  above  formats,
  179.      and vice versa.  
  180.  
  181.  
  182. PARAMETERS    PARAMETERS  
  183.      Exactly   one   of  the  following  operations  may  be
  184.      specified for an input name: 
  185.  
  186.      px q BinHex 4.0 - files in the MacBinary  format  are
  187.      translated to  BinHex  files,  or vice versa.  The name
  188.      argument may be the name of a file to be converted or a 
  189.      basename  to  which  an  appropriate  suffix  must   be
  190.      appended to  get a filename.  If the conversion is from
  191.      Binhex 4.0 to MacBinary, several files may comprise the 
  192.      BinHex representation of the Mac  file.    Rather  than
  193.  
  194.  
  195.                                                                 1
  196.  
  197. MCVERT (LOCAL)             May 5, 1987             MCVERT (LOCAL)
  198.  
  199.  
  200.      manually concatenate the files and manually delete mail 
  201.      headers  and  other extraneous garbage, one may specify
  202.      the names of the files in order and pmcvert q will do 
  203.      the concatenating  and  deleting.      Conversely,   in
  204.      converting  a  MacBinary  file to BinHex 4.0 format for
  205.      mailing over long distances, one may be  restricted  to
  206.      mail messages of no greater that some fixed length.  In 
  207.      this  case,  pmcvert  q  can automatically divide the
  208.      BinHex  file  into  pieces   and   label   each   piece
  209.      appropriately.  Option 'x' is selected by default.  
  210.  
  211.      pr  q  Resource  - files in the MacBinary format with
  212.      empty data forks and nonempty resource forks  are  made
  213.      from ordinary data files, or vice versa.  
  214.  
  215.      pd  q  Data  -  files  in  the  MacBinary format with
  216.      nonempty data forks and empty resource forks  are  made
  217.      from ordinary data files, or vice versa.  
  218.  
  219.      pu  q  Text  -  files  in  the  MacBinary format with
  220.      nonempty data forks and empty resource forks  are  made
  221.      from ordinary  data files, or vice versa.  Unix newline
  222.      characters are  interchanged  with  MacIntosh  carriage
  223.      return  characters,  and a newly created MacBinary file
  224.      has creator field given by the  MAC_EDITOR  environment
  225.      variable.  
  226.  
  227.  
  228. OPTIONS    OPTIONS  
  229.  
  230.      pp  |  q  q  If  a  BinHex to MacBinary conversion is
  231.      taking place and option 'p' is selected,  any  file  of
  232.      type  "PIT  "  will  be  unpacked  into its constituent
  233.      parts.  This option does not recursively unpack "PIT  "
  234.      files packed in "PIT " files.  If a MacBinary to BinHex 
  235.      conversion  is  taking  place, this option is currently
  236.      ignored.  By default, option 'q' is selected.  
  237.  
  238.      pU | D q When option 'U' is selected, the  conversion
  239.      that  takes  place  is  the  one suitable for Uploading
  240.      files.  That is, the conversion is  from  MacBinary  to
  241.      something else  when  'U'  is  selected.    Conversely,
  242.      option 'D', as in Download, converts from something  to
  243.      MacBinary. Option 'D' is the default.  
  244.  
  245.      ps  |  v  q  Normally,  pmcvert  q prints to stderr
  246.      information about the files it is creating.   Selecting
  247.      option  's',  as  in  silent,  disables this reporting.
  248.      Option 'v', for verbose, is the default.  
  249.  
  250. ENVIRONMENT VARIABLES    ENVIRONMENT VARIABLES  
  251.      There are four environment variables  one  may  use  to
  252.      customize  the behavior of pmcvert q slightly.  
  253.  
  254.      pMAC_EDITOR  q  The  creator  of MacBinary text files
  255.      produced with options -uD.  The default  is  MACA,  the
  256.      creator type of MacWrite.  
  257.  
  258.      pMAC_DLOAD_DIR  q  The  MacBinary  files created when
  259.  
  260.  
  261.                                                                 2
  262.  
  263. MCVERT (LOCAL)             May 5, 1987             MCVERT (LOCAL)
  264.  
  265.  
  266.      option -D is selected are  placed  in  this  directory.
  267.      The default is ".", the current working directory.  
  268.  
  269.      pMAC_EXT q The MacBinary files created when option -D 
  270.      is  selected  are named according to the filename field
  271.      stored in the file header, with the  name  extended  by
  272.      this suffix.  The default is ".bin".  
  273.  
  274.      pMAC_LINE_LIMIT  q  The  BinHex  files  created  when
  275.      option -U is selected may be no longer than  this  many
  276.      lines long.    Files  that  would otherwise exceed this
  277.      line limit  are  broken  up  into  several  files  with
  278.      numbers  embedded  into their file  names to show their
  279.      order.  Each such file has "Start of part x"  and  "End
  280.      of part x" messages included where appropriate.  
  281.  
  282. BUGS    BUGS  
  283.      It  should  be  possible  to  discard bad input now and
  284.      successfully translate good input later, but bad  input
  285.      mostly just causes immediate termination.  
  286.  
  287.      A  more  diligent  person  would support BinHex 3.0 and
  288.      BinHex 2.0 and BinHex 5000.0 B. C., but I've never seen 
  289.      anyone use them in three years.  A more diligent person 
  290.      would also do something for users of macget and macput, 
  291.      but hopefully someone will make those programs  support
  292.      the MacBinary file protocol.  
  293.  
  294. SEE ALSO    SEE ALSO  
  295.      xbin(1), macget(1), macput(1), xmodem(1), kermit(1) 
  296.  
  297. AUTHOR    AUTHOR  
  298.      Doug  Moore, Cornell University Computer Science. Based
  299.      upon pxbin q by Dave Johnson,  Brown  University,  as
  300.      modified  by  Guido  van Rossum, and upon punpit q by
  301.      Allan G. Weber, as well  as  upon  correspondence  with
  302.      several helpful readers of USENET.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                 3
  328.  
  329.